package com.kakarote.hrm.service;

import com.alibaba.fastjson.JSONObject;
import com.kakarote.common.log.entity.OperationLog;
import com.kakarote.core.entity.BasePage;
import com.kakarote.core.entity.UploadEntity;
import com.kakarote.core.servlet.BaseService;
import com.kakarote.hrm.entity.BO.QueryRecruitPositionPageListBO;
import com.kakarote.hrm.entity.PO.HrmRecruitPosition;
import com.kakarote.hrm.entity.VO.RecruitPositionVO;
import org.springframework.web.multipart.MultipartFile;

import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.List;

/**
 * <p>
 * 招聘岗位 服务类
 * </p>
 *
 * @author system
 * @since 2024-01-01
 */
public interface IHrmRecruitPositionService extends BaseService<HrmRecruitPosition> {

    /**
     * 添加招聘岗位
     *
     * @param recruitPosition 招聘岗位
     * @return 操作日志
     */
    OperationLog addRecruitPosition(HrmRecruitPosition recruitPosition);

    /**
     * 修改招聘岗位
     *
     * @param recruitPosition 招聘岗位
     * @return 操作日志
     */
    OperationLog setRecruitPosition(HrmRecruitPosition recruitPosition);

    /**
     * 获取招聘岗位详情
     *
     * @param positionId 计划岗位id
     * @return 岗位详情
     */
    RecruitPositionVO queryById(Long positionId);

    /**
     * 查询招聘岗位列表
     *
     * @param queryRecruitPositionPageListBO 查询条件
     * @return 分页结果
     */
    BasePage<RecruitPositionVO> queryRecruitPositionPageList(QueryRecruitPositionPageListBO queryRecruitPositionPageListBO);

    /**
     * 根据计划id查询所有岗位列表
     *
     * @param planId 计划id
     * @return 岗位列表
     */
    List<RecruitPositionVO> queryByPlanId(Long planId);

    /**
     * 删除招聘岗位
     *
     * @param positionId 计划岗位id
     * @return 操作日志
     */
    OperationLog deleteRecruitPosition(Long positionId);

    /**
     * 批量删除招聘岗位
     *
     * @param positionIds 计划岗位id列表
     * @return 操作日志
     */
    OperationLog batchDeleteRecruitPosition(List<Long> positionIds);

    /**
     * 根据计划id删除所有岗位
     *
     * @param planId 计划id
     * @return 操作日志
     */
    OperationLog deleteByPlanId(Long planId);

    /**
     * 导出招聘岗位
     *
     * @param response                           HTTP响应
     * @param queryRecruitPositionPageListBO 查询条件
     * @throws IOException IO异常
     */
    void exportRecruitPosition(HttpServletResponse response, QueryRecruitPositionPageListBO queryRecruitPositionPageListBO) throws IOException;

    /**
     * 下载导出模板
     *
     * @param response HTTP响应
     */
    void downloadExcel(HttpServletResponse response);

    /**
     * excel导入岗位
     *
     * @param file 文件对象
     * @return 导入结果
     */
    JSONObject excelImport(MultipartFile file);

    /**
     * 上传临时文件，此文件会七天后删除
     *
     * @param file    文件对象
     * @param batchId batchId
     * @return entity
     */
    UploadEntity uploadTempFile(MultipartFile file, String batchId);
}
